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Executive  Summary 

DIRECTORY  OF  RESERVE  MEDICAL  PERSONNEL 

We  developed  the  automated  Unit  Directory  of  Selected  Reserve  Medical 
Personnel  to  assist  the  Joint  Medical  Readiness  Training  Center  (JMRTC)  plan  the 
work  of  mobile  training  teams  responsible  for  conducting  the  nonresident  Combat 
Casualty  Care  Course  (C4).  The  students  are  physicians,  dentists,  nurses,  and 
medical  enlisted  personnel  assigned  to  reserve  component  units  of  the  four  Military 
Services.  The  directory  operates  on  personal  computers. 

Prior  to  the  development  of  the  directory,  the  JMRTC  relied  on  printed 
directories  published  by  each  reserve  component.  They  failed  to  include  much  of  the 
needed  information  and  were  difficult  to  use.  The  automated  directory  makes  more 
information  available  to  planners,  collates  the  information  for  all  reserve  compo¬ 
nents,  and  computes  the  mileage  between  training  sites  and  reserve  units.  In 
addition  to  providing  tabular  data,  the  directory  uses  color  graphics  superimposed  on 
road  maps  to  display  unit  locations. 

The  directory  is  being  used  successfully  by  the  JMRTC.  Trip  planning  time  has 
been  reduced,  and  the  training  trips  are  now  more  efficient  because  the  new  system 
identifies  more  potential  students  in  each  geographical  area. 

Although  the  directory  was  designed  for  administering  the  C4  program,  it  has 
other  potential  applications.  It  can  be  used  by  a  single  Service  or  reserve  component 
to  plan  mobile  training  team  visits  for  other  health-care  courses.  The  directory  can 
also  be  helpful  to  staffs  involved  in  Joint  Service  medical  mobilization  planning.  In 
this  report,  we  discuss  expansions  to  the  directory  that  would  be  useful  to  JMRTC 
and  other  potential  users. 
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CHAPTER  1 


BACKGROUND 


The  Military  Medicine  Education  Institute  (MMEI)i  asked  the  Logistics 
Management  Institute  (LMI)  to  develop  a  personal-computer  (PC)-based  information 
system  for  locating  reserve  component  units  with  medical  personnel.  The  system  we 
developed,  the  Unit  Directory  of  Selected  Reserve  Medical  Personnel,  is  being  used  by 
the  Joint  Medical  Readiness  Training  Center  (JMRTC)  at  Fort  Sam  Houston,  San 
Antonio,  Texas.  The  unit  directory  helps  JMRi’C  plan  the  work  of  mobile  medical 
training  teams  responsible  for  conducting  the  nonresident  Combat  Casualty  Care 
Course  (C4). 

The  objective  of  C4  training  is  to  prepare  medical  personnel,  primarily 
physicians  and  nurses,  to  live  and  practice  in  the  battlefield  area.  Currently,  two  C4s 
are  taught.  The  resident  course  at  Camp  Bullis,  Texas,  takes  9  days  to  complete,  is 
taught  in  a  field  environment,  and  provides  training  to  mostly  active  military 
personnel.  The  nonresident  C4,  which  the  unit  directory  supports,  encompasses 
personnel  assigned  to  units  of  the  Army  National  Guard  (ARNG),  U.S.  Army  Reserve 
(USAR),  U.S.  Naval  Reserve  (USNR),  U.S.  Marine  Corps  Reserve  (USMCR),2  Air 
National  Guard  (ANG),  and  U.S.  Air  Force  Reserve  (USAFR).  It  is  designed  into 
three  2-  to  2-J-day  phases,  or  modules,  that  enable  a  reservist  to  complete  the  course 
over  a  3-year  period. 

Phases  I  and  HI  are  delivered  by  JMRTC  mobile  training  teams  to  sites  close  to 
clusters  of  reserve  units  and  are  taught  in  ~  classroom  setting.  Phase  n,  the  field 
training  exercise,  is  given  at  regional  training  sites  in  Puerto  Rico,  Wisconsin, 
California,  Massachusetts,  and  Mississippi. 

Phase  I  includes  lectures  on  nuclear,  biological,  chemical  (NBC)  warfare, 
environmental/preventive  medicine,  and  quad-service  medical  management. 
Phase  II  is  the  field  training  exercise  on  battlefield  patient  care  from  the  point  of 


JMMEI  is  a  component  of  the  Uniformed  Services  University  of  Health  Sciences,  located  in 
Bethesda,  Maryland.  The  JMRTC  is  a  field  element  of  MMEI. 

2Health-care  personnel  assigned  to  USMCR  units  are  members  of  the  USNR 
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injury  to  the  battalion  aid  station.  In  Phase  m,  the  student  is  required  to  complete 
one  of  the  following  seven  specialized  courses: 

•  Advanced  Trauma  Life  Support 

•  Advanced  Burn  Life  Support 

•  Advanced  Cardiac  Life  Support 

•  Prehospital  Trauma  Life  Support3 

•  Combat  Casualty  Care  Nursing 

•  Deployment  Medicine 

•  Combat  Anesthesia. 

To  control  costs  and  maximize  attendance  by  members  of  all  reserve 
components,  the  training  team  itinerary  must  be  planned  carefully.  Prior  to  the 
development  of  the  automated  directory,  the  JMRTC  encountered  difficulty  identify¬ 
ing  the  appropriate  reserve  units  and  the  potential  students.  It  relied  on  printed 
directories  of  medical  units  prepared  by  each  of  the  reserve  components,  and  those 
directories  were  inadequate  for  the  following  reasons: 

•  They  excluded  nonmedical  units  that  have  medical  billets  and  medical 
personnel.  These  personnel  were  almost  never  invited  to  attend  courses 
given  in  their  geographic  areas. 

•  They  did  not  contain  information  on  the  number  and  type  of  medical  person¬ 
nel  assigned  to  the  medical  units.  Without  that  information,  the  JMRTC 
had  difficulty  estimating  the  number  of  students  eligible  for  training  at  a 
given  location. 

•  They  did  not  show  the  geographic  location  of  parts  of  a  medical  unit 
(detachments)  that  are  separated  from  the  unit  headquarters. 

•  They  did  not  help  in  computing  mileage  between  medical  units.  Mileage 
calculations  were  made  by  using  road  maps  in  conjunction  with  the  five 
different  reserve  component  directories. 


3  Prehospital  Trauma  Life  Support  is  designed  for  enlisted  personnel. 
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The  new  automated  directory  solves  all  of  these  problems: 

•  It  expands  the  information  previously  available  to  JMRTC  from  printed 
directories 

•  It  collates  unit  information  from  all  reserve  components  into  a  single  Joint 
Service  Directory 

•  It  computes  the  specific  mileage  between  a  training  site  and  all  units  located 
within  250  miles  of  that  site  and  displays  this  information  graphically  with 
road  maps. 

The  automated  directory  helps  JMRTC  deliver  the  C4  to  more  students  and 
improves  the  efficiency  of  the  training  teams.  It  also  reduces  the  time  required  to 
develop  the  trip  plans  for  the  teams. 

The  automated  directory  was  conceived  and  financed  by  MMEI.  Other  DoD 
organizations  that  want  to  use  the  system  should  contact  MMEI. 
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CHAPTER  2 


DESIGN  OF  THE  UNIT  DIRECTORY 


This  chapter  provides  an  overview  of  the  design  of  the  system.  A  complete  users 
guide  is  presented  in  Appendix  A  and  a  maintenance  manual  is  provided  in 
Appendix  B. 

The  automated  directory  provides  the  user  with  answers  to  the  following  kinds 
of  questions  about  reserve  component  units  with  assigned  medical  personnel. 

•  What  units  are  located  in  [name  of  state]  or  within  150  miles  of  [city  in 
named  state]  crossing  state  boundaries? 

•  What  are  the  medical  duty  assignments  of  the  personnel  in  the  selected  set 
of  units  or  in  any  specific  unit  within  the  set? 

•  What  are  the  mailing  address  and  phone  number  of  each  unit? 

•  What  are  the  major  roads  surrounding  the  selected  units? 

SCOPE 

The  directory  holds  data  on  3,640  Selected  Reserve  units,  seme  of  which  are 
detachments  of  larger  medical  units.1  The  system  captures  information  at  the  lowest 
level  of  unit  organization  identified  with  a  unit  identification  code  (UIC).  Table  2-1 
distributes  these  units  by  Service  and  reserve  component. 

These  3,640  units  contain  97,096  personnel  who  hold  medical  assignments. 
Table  2-2  distributes  the  personnel  by  Service  and  reserve  component. 


Un  the  National  Guard,  split  units  are  located  within  the  same  state.  In  the  Reserve,  the 
detachments  may  be  spread  among  several  states. 
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TABLE  2-1 


NUMBER  OF  SELECTED  RESERVE  UNITS  IN  THE  DIRECTORY 
(As  of  August  1989) 


Service 

Reserve 

component 

Medical  units 

Nonmedical 

units3 

Total 

Army 

National  Guard 

248 

802 

1,050 

Reserve 

460 

522 

982 

Navyb 

Reserve 

467 

752 

1,219 

Air  Force 

National  Guard 

116 

148 

264 

Reserve 

91 

34 

125 

All  Services 

Total 

1,382 

2,258 

3,640 

a  These  nonmedical  units  have  personnel  who  are  assigned  to  medical  positions. 

b  Includes  units  of  the  USNR  and  USMCR  Medical  personnel  assigned  to  USMCR  units  are  members  of  the  USNR. 


TABLE  2-2 

NUMBER  OF  PERSONNEL  IN  THE  DIRECTORY  ASSIGNED 
TO  MEDICAL  POSITIONS  IN  SELECTED  RESERVE  UNITS 
(As  of  August  1989) 


Service 

Reserve 

component 

Medical  units 

Nonmedical 

units 

Total 

Army 

National  Guard 

12,538 

9,460 

21,998 

Reserve 

39,014 

2,500 

41,514 

Navy 

Reserve 

15,943 

2,699 

18,642 

Air  Force 

National  Guard 

5,319 

357 

5,676 

Reserve 

9,122 

144 

9,266 

All  Services 

Total 

81,936 

15,160 

97,096 

Note:  These  figures  exclude  personnel  awaiting  or  undergoing  initial  skill  training  (primarily  enlisted  personnel). 
These  figures  also  exclude  individual  mobilization  augmentees  (IMAs)  for  all  Services.  Air  Force  IMA  personnel  are 
shown  separately  m  the  directory. 
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Personnel  are  selected  for  inclusion  in  the  directory  based  on  their  duty  assign¬ 
ment  code  rather  than  on  their  primary  skill  code.2  The  duty  assignment  code 
indicates  the  job  the  individual  is  currently  filling  or  will  likely  perform  if  the  unit 
mobilizes.  Some  personnel  are  assigned  to  medical  jobs  that  do  not  match  their 
primary  skills.  The  directory  is  based  on  duty  assignment  because  the  purpose  of 
supplementary  training  and  sustainment  training  is  to  help  people  perform  their 
likely  mobilization  duties.  The  directory  can  be  modified  to  add  the  primary  skill 
codes  of  personnel. 

The  directory  excludes  personnel  awaiting  or  undergoing  initial  skill  training. 
Nearly  all  of  these  are  enlisted  personnel.  Those  who  are  undergoing  training  are  in 
training  centers  and  schools  away  from  their  reserve  units.  Those  who  are  awaiting 
initial  training  are  not  qualified  for  C4  training. 

DATA  SOURCES 

Table  2-3  shows  the  data  sources  used  to  identify  medical  personnel  and  unit 
locations. 


TABLE  2-3 

DATA  SOURCES  FOR  THE  DIRECTORY 


Information 

Service 

Data  source 

Assigned 

personnel9 

Army  and  Air  Force 

Reserve  Components  Common  Personnel  Data 

System  (RCCPDS) 

Navy 

Inactive  Officer/Enlisted  Master  files 

Unit  address 
information 

All  Services 

Unit  Address  Report 

Army 

Directory  of  Army  National  Guard  medical  units 
Directory  of  USAR  AMEDD  units 

Air  Force 

Air  National  Guard  medical  technicians  directory 

Air  Force  Reserve  medical  units  by  state  and  city 

Navy 

Naval  Surface  Reserve  Directory 

Note:  AMEDD  =  Army  Medical  Department 
*  As  of  August  1989 


2 All  USNR  personnel  are  included  based  on  their  primary  skill  code  because  duty  assignment 
data  are  not  available  for  about  one-third  of  the  medical  personnel . 
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The  major  data  source  for  the  unit  address  information  is  the  Defense 
Manpower  Data  Center  Unit  Address  Report.  We  supplemented  information  from 
that  report  with  data  from  reports  produced  by  the  Services.  The  quality  of  the 
address  information  in  the  directory  is  very  good;  the  addresses  are  complete  for 
97.7  percent  of  the  units.  Telephone  numbers  are  available  for  88  percent  of  the 
medical  units  and  47  percent  of  the  nonmedical  units.  Medical  units  contacted  by 
JMP.TC  can  often  provide  telephone  numbers  for  nearby  nonmedical  units.  As  the 
directory  is  used,  the  missing  telephone  numbers  will  be  added  to  the  directory  by 
JMRTC. 

The  RCCPDS  is  the  source  for  information  on  Army  and  Air  Force  persoi  .el. 
The  Navy  data  were  pulled  from  the  Inactive  Officer/Eniisted  Master  files 
maintained  by  the  Naval  Reserve  Personnel  Center  (NRPC). 

SYSTEM  OPERATION 

The  system  is  easy  to  learn  and  easy  to  use.  We  have  trained  operators  to  use  it 
in  about  30  minutes.  The  users  guide  (Appendix  A)  is  a  self-teaching  tool.  In  this 
section,  we  describe  the  process  of  selecting  units  and  generating  reports. 

Unit  Selection 

The  first  step  in  selecting  units  is  to  define  a  set  of  units.  To  do  so,  a  selection 
must  be  made  from  each  of  the  following  categories: 

•  Unit  type 

•  Service  component 

•  Corps 

•  Location. 

Unit  Type 

Three  options  are  available  under  unit  type: 

•  All  units 

•  Medical 

•  Nonmedical. 
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Units  are  defined  as  either  medical  or  nonmedical.  An  example  of  a  medical 
unit  is  a  1,000-bed  General  Hospital;  an  example  of  a  nonmedical  unit  is  an 
F-16  squadron  that  contains  a  medical  element.  The  user  can  restrict  the  units 
selected  to  either  medical  units  or  nonmedical  units  or  can  decide  to  display  both 
types  of  units. 

Service  Component 

Seven  options  are  available  in  selecting  the  Service  component: 

•  All  Components 

•  ARNG 

•  USAR 

•  AFR 

•  ANG 

•  NR  (includes  USMCR) 

•  IMA  (Air  Force  Medical  IMAs). 

The  user  can  select  one  or  more  Service  components.  JMRTC  users  usually 
select  the  "All  Components”  option  in  order  to  display  all  units  in  a  given  geographic 
area.  The  next  step  enables  the  user  to  further  define  the  units  selected  for  display. 

Corps 

Eleven  options  are  available  in  selecting  the  corps: 

•  All  Personnel 

•  Enlisted 

•  Warrant  Officers 

•  All  Officers 

•  Medical  Corps 

•  Nurse  Corps 

•  Medical  Specialist  Corps 

•  Dental  Corps 
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•  Medical  Service  Corps 

•  Veterinary  Corps 

•  Biomedical  Science  Corps. 

The  corps  options  enable  the  user  to  display  only  those  units  that  have  specific  types 
of  health-care  specialists.  For  example,  if  the  user  checks  "Medical  Corps,”  the 
dire  ctory  will  display  only  those  units  that  have  physicians  and  will  exclude  all  other 
units.  The  users  can  select  one  or  more  specialty  groups  or  check  the  "All  Personnel” 
category  to  ensure  all  units  are  displayed. 

Location 

The  final  unit  selection  is  made  among  five  choices  for  location: 

•  All  Locations 

•  State 

•  One-Digit  Zip  Code 

•  Three-Digit  Zip  Code 

•  Five-Digit  Zip  Code  and  Radius  in  Miles. 

The  location  selection  limits  the  units  chosen  to  a  specific  geographical  area. 
When  the  user  selects  "All  Locations,”  all  units  that  meet  the  previously  selected 
criteria  are  included,  regardless  of  their  locations.  Normally,  unit  selection  is  limited 
to  a  specific  geographic  location.  For  example,  one  or  more  states  can  be  selected  by 
using  the  "State”  option.  The  "One-Digit  Zip  Code”  option  can  be  used  to  select  a 
group  of  states.  For  example,  a  first  digit  of  three  might  select  all  units  in  Tennessee, 
Mississippi,  Alabama,  and  Georgia.  Use  of  a  'Three-Digit  Zip  Code”  limits  the  search 
to  a  region  within  a  state.  A  closer  search  may  be  made  by  using  a  five-digit  zip  code 
and  specifying  the  desired  distance  in  miles  around  that  zip  code.  The  system  permits 
the  selection  of  any  distance  up  to  250  miles. 
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Reports 

After  defining  the  set  of  units,  the  user  is  ready  to  produce  a  report.  Users  can 
produce  the  following  five  types  of  reports: 

•  Unit  listing  report 

•  Specialty  report 

•  Corps  report 

•  Unit  report 

•  Graphics  report. 

Unit  Listing  Report 

The  basic  report  is  the  unit  listing.  It  presents  the  following  information  for 
each  unit: 

•  UIC 

•  Reserve  Component 

•  Title 

•  City 

•  State 

•  Zip  Code 

•  Number  of  Officers  Assigned  to  Medical  Positions 

•  Number  of  Warrant  Officers  Assigned  to  Medical  Positions 

•  Number  of  Enlisted  Personnel  Assigned  to  Medical  Positions. 

The  bottom  row  of  the  report  shows  a  total  for  the  officers,  warrant  officers,  and 
enlisted  personnel  and  the  number  of  units.  The  other  four  types  of  reports  are 
produced  from  the  unit  listing  report. 

Specialty  Report 

The  specialty  report  shows  the  medical  positions  held  by  personnel  assigned  to 
the  selected  set  of  units.  This  information  helps  JMRTC  estimate  the  number  of 
potential  students  for  C4  training  in  a  specified  geographical  area.  The  report 
aggregates  the  number  of  people  assigned  to  each  type  of  medical  specialty 


2-7 


(e.g.,  internist,  orthopedic  surgeon,  operating  room  nurse,  X-ray  technician)  using 
the  occupational  codes  of  each  Service.  The  report  can  be  produced  for  the  entire  set 
of  selected  units  or  for  a  specific  unit  within  the  selected  set. 

Corps  Report 

The  specialty  report  displays  the  personnel  in  a  set  of  units  by  specific  medical 
specialty.  The  corps  report  aggregates  the  same  information  by  corps  (e.g.,  Medical 
Corps,  Nurse  Corps). 

Unit  Report 

The  unit  report  provides  the  following  information  on  any  unit  included  on  a 
unit  listing: 

•  Street  Address 

•  City 

•  State 

•  Zip  Code 

•  Phone  Number 

•  Reserve  Component 

•  Whether  the  unit  is  medical  or  nonmedical 

•  Number  of  personnel  by  corps. 

Graphics  Report 

The  graphics  report,  in  color,  superimposes  a  set  of  units  on  a  map.  This  map 
increases  the  planner’s  understanding  of  where  units  are  located  by  plotting  them  in 
relation  to  metropolitan  areas  and  interstate  highways.  The  following  information  is 
included  on  most  maps: 

•  State  borders  (heavy  red  lines) 

•  Interstate  highways  (white  lines) 

•  Three-digit  zip  code  boundaries  (dashed  red  lines) 

•  Army  unit  locations  (green  stars) 
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•  N avy  unit  locations  (white  anchors) 

•  Air  Force  unit  locations  (blue  airplanes). 

The  mapping  software  allows  the  user  to  manipulate  the  data  graphically  in  the 
following  ways: 

•  Enlarging  or  shrinking  the  map  area 

•  Searching  for  a  specific  unit  on  a  map 

•  Magnifying  a  portion  of  a  map 

•  Printing  the  map. 

The  maps  can  cross  state  boundaries.  For  example,  if  the  proper  selection  is 
made,  the  map  will  display  units  located  in  the  Washington,  D.C.,  metropolitan  area 
covering  the  District  of  Columbia  and  the  nearby  counties  in  Virginia  and  Maryland. 

The  formats  for  the  reports  we  have  described  in  this  chapter  are  shown  in 
Appendix  A,  the  users  guide.  That  guide  provides  a  detailed  explanation  and  tutorial 
for  using  the  system. 
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CHAPTER  3 


FUTURE  CHANGES 


We  installed  the  directory  at  the  JMRTC  in  December  1989,  and  based  on 
discussions  with  users  there,  we  recommend  the  following  directory  enhancements: 

•  Adding  Army  and  Navy  Individual  Mobilization  Augmentees  (IMAs):  An 
IMA  is  a  trained  reservist  assigned  to  a  mobilization  billet  in  an  active  unit. 
Currently,  the  directory  includes  the  name,  medical  specialty,  and  home 
address  of  Air  Force  IMAs.  That  information  enables  JMRTC  to  contact  Air 
Force  IMAs  who  may  reside  within  commuting  distance  of  a  planned  C4 
training  site  and  invite  them  to  attend  the  course.  The  directory  should  be 
expanded  to  also  include  Army  and  Navy  IMAs. 

•  Adding  Home  Addresses  for  National  Army  Augmentation  Detachment 
Personnel:  The  National  Army  Augmentation  Detachment  and  the  First 
Army  Physician  Management  Branch  were  established  several  years  ago  by 
the  USAR  to  recruit  and  administer  physicians  and  nurses  who  did  not  live 
within  commuting  distance  of  a  USAR  unit.  Members  of  these  detachments 
attend  training  drills  near  their  homes  but  are  assigned  to  units  located 
elsewhere.  Currently,  the  directory  includes  them  with  the  personnel  of 
their  units.  The  home  addresses  of  these  people  should  be  added  to  the 
directory  to  enable  the  JMRTC  to  invite  them  to  attend  C4  training  given 
near  their  homes. 

•  Updating:  The  directory  should  be  updated  at  least  annually  and  preferably 
semiannually  to  maintain  its  utility  of  the  directory. 

The  installed  directory  was  demonstrated  to  the  Reserve  Component  Medical 
Council  (RCMC)  in  January  1990  and  at  the  Forces  Command  (FORSCOM)  Medical 
Conference  in  March  1990.  Based  on  discussions  with  participants  at  these  confer¬ 
ences,  we  believe  that  the  directory  can  be  useful  to  other  DoD  organizations.  For 
example,  staffs  involved  in  Joint  mobilization  planning  for  medical  units  should  find 
it  useful  because  it  integrates  the  Selected  Reserve  units  of  all  Services  into  a  single 
automated  data  base.  The  directory  would  also  be  useful  to  Service  staffs  responsible 
for  planning  mobile  training  team  visits  to  their  own  reserve  medical  units. 
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During  these  discussions,  we  received  suggestions  for  modifying  the  directory  to 
meet  the  needs  of  these  potential  users.  We  have  examined  the  feasibility  of  making 
the  following  changes: 

•  Adding  Active  Component  Medical  Units  and  Personnel:  Some  potential 
users  would  like  to  have  a  single  automated  directory  that  integrates  active 
and  reserve  medical  units.  A  total  force  directory  is  feasible. 

•  Including  Primary  Skill  Code:  The  directory  currently  identifies  personnel 
in  terms  of  their  duty  assignments  rather  than  the  primary  skill  held  by  the 
individual.  For  example,  an  internist  assigned  to  a  general  surgeon’s 
position  is  shown  in  the  directory  as  a  general  surgeon.  This  method  suits 
the  needs  of  JMRTC  planners  because  they  are  interested  in  the  current 
mobilization  assignments  of  the  personnel  to  be  trained.  Other  potential 
users  of  the  directory  are  interested  only  in  the  primary  qualifications  of  the 
personnel  and  some  want  to  have  information  on  both  their  duty  assign¬ 
ments  and  their  primary  qualifications  in  order  to  identify  skill  mismatch 
problems.  The  directory  can  be  expanded  to  add  information  on  the  primary 
skill  of  medical  personnel. 

•  Adding  Capability  to  Select  Units  Containing  Specific  Medical  Skills:  The 
current  directory  provides  the  user  with  the  capability  to  select  only  those 
units  that  have  personnel  assigned  to  a  specific  corps  (e.g.,  Medical  Corps, 
Dental  Corps,  Nurse  Corps,  etc.).  This  capability  is  adequate  for  JMRTC. 
Other  potential  users  have  indicated  an  interest  in  being  able  to  isolate 
units  that  have  personnel  with  specific  skills  or  groups  of  skills.  For 
e  ample,  they  may  wish  to  identify  all  units  that  contain  orthopedic 
surgeons  or  thoracic  surgeons  or  units  that  have  both  nurse-anesthetists  and 
operating  room  nurses.  The  directory  can  be  modified  to  provide  this 
capability. 
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APPENDIX  A 


USERS  GUIDE 


INTRODUCTION 

This  users  guide  contains  information  on  using  the  querying,  reporting,  and 
mapping  capabilities  of  the  Unit  Directory  of  Selected  Reserve  Medical  Personnel. 
The  basic  version  of  the  system,  without  geographic  output,  requires: 

•  An  IBM-AT-compatible  computer  with  640K  of  main  memory  with  MS-DOS 
Version  2.11  or  greater. 

•  Six  megabytes  of  disk  storage  space. 

•  A  80386-based  machine  is  highly  desirable. 

Geographic  display  requires  in  addition: 

•  A  graphics  video  adapter  and  monitor  (EGA  or  VGA  are  highly  desirable) 

•  Additional  12  megabytes  of  disk  storage 

•  A  license  for  Maplnfo  Run-Time  Version  4.0  from  MAPINFO  Corporation, 
Troy,  New  York,  including  the  MapPack  Sampler. 

For  output  of  geographic  displays,  you  will  need  a  graphics  printer  or  plotter.  A  list  of 
display  devices,  printers,  and  plotters  is  shown  in  the  Annex. 

The  basic  version  of  the  system  is  written  in  Clipper,  Summer  1987  version, 
from  Nantucket  Corporation,  Los  Angeles,  California.  The  geographic  display 
portion  is  an  application  written  in  MapCode,  the  Maplnfo  Application  Language. 

SYSTEM  OVERVIEW 

The  system  contains  information  on  all  reserve  units  with  personnel  assigned  to 
medical  positions.  Using  the  main  selection  screen  shown  in  Figure  A-l,  you  can 
query  a  data  base  of  all  units  satisfying  your  selection  criteria,  and  you  can  produce  a 
report  listing  them.  The  example  shows  selection  criteria  for  all  units  within 
100  miles  of  the  zip  code  33602. 
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FIG.  A-1.  SELECTION  CRITERIA  SCREEN 


Once  selection  criteria  are  specified  using  this  screen,  the  software  can  select 
and  list  the  qualified  units.  The  report  produced  on  the  screen,  shown  in  Figure  A-2, 
can  be  sorted  in  various  orders  and  produced  as  hard  copy.  The  data  can  also  be 
superimposed  on  a  map  and  examined  geographically  by  selecting  the  mapping 
option  shown  in  Figure  A-3. 
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FIG.  A-2.  REPORT  PRODUCED  FROM  SELECTION  CRITERIA  IN 

FIGURE  A-1 
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Lesson  1:  Navigating  Within  "Unit  Type"  Selection  Criteria 

Suppose  you  wish  to  generate  a  list  of  units  in  Maine,  Vermont,  and 
New  Hampshire  that  have  medical  officers.  Begin  by  invoking  the  system  from  the 
DOS  prompt: 

main  -4-1 

The  system  will  then  display  the  screen  shown  in  Figure  A-4  which  allows  you  to 
enter  selection  criteria  for  the  report  you  wish  to  produce. 
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FIG.  A-4.  INITIAL  SCREEN 


On  a  color  monitor,  the  box  on  the  left  of  the  screen  ("Unit  Type”)  will  be  highlighted 
in  yellow.  It  lets  you  select  whether  you  want  to  look  at  just  medical  units 
("Medical”),  just  nonmedical  ("Nonmedical”)  or  both  medical  and  nonmedical  units 
("All  Units”).  Note  also  that  your  current  selection,  "All  Units,”  is  highlighted. 
Experiment  with  the  up  and  down  arrow  keys  to  change  the  highlighted  option.  Hit 
the  "Home”  and  "End”  keys  and  note  how  you  move  to  the  first  and  last  highlighted 
option. 


Now,  we  are  going  to  select  "All  Units”  as  follows: 

•  Hit  the  "Home”  key  to  move  to  the  first  option,  "All  Units.” 

•  Hit  "Enter”  and  note  that  a  checkmark  appears  by  "All  Units”  (see 
Figure  A-5).  The  checkmark  means  that  of  the  three  choices  available  in  the 
"Unit  Type”  category,  "All  Units”  was  selected. 
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FIG.  A-5.  SELECTION  SCREEN  WITH  "ALL  UNITS"  SELECTED 


Lesson  2:  Navigating  Between  Selection  Criteria  Boxes 

You  cannot  yet  generate  a  report  because  you  must  select  criteria  for  each  of  the 
boxes  on  the  screen.  Move  now  to  the  "Component”  box  by  pressing  the  right  arrow 
key.  Now  the  "Unit  Type”  box  is  no  longer  highlighted  (white)  and  the  "Component” 
box  is  highlighted  in  yellow.  As  with  the  "Unit  Type”  box,  you  can  move  up  and  down 
the  various  criteria  with  the  up  and  down  arrow  keys.  Now,  do  the  following: 

•  Position  the  cursor  to  the  "All  Components”  option  with  the  up  arrow  or 
"Home”  key. 

•  Hit  "Enter”  so  that  a  checkmark  appears  beside  "All  Components.” 

•  Move  to  the  "Corps”  box  with  the  right  arrow  key. 

•  Select  the  "Medical  Corps”  option  criterion  by  hitting  the  down  arrow  four 
times,  and  hit  "Enter”  to  put  a  checkmark  beside  "Medical  Corps.” 


Your  screen  should  now  look  like  Figure  A-6.  Experiment  with  the  right  and  left 
arrow  keys  to  see  how  to  move  between  the  boxes.  Notice  that  as  you  move,  your 
selections  are  maintained.  If  you  move  into  the  "Location”  box,  you  will  not  be  able  to 
leave  until  you  have  specified  a  location.  (If  this  happens  move  on  to  Lesson  3.)  You 
now  only  need  to  specify  "Location”  and  you  are  ready  to  produce  a  report. 
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FIG.  A-6.  ALL  SELECTION  CRITERIA  SPECIFIED  EXCEPT  LOCATION 


Lesson  3:  Selecting  a  Location 

We  will  now  specify  that  we  wish  to  see  only  the  units  in  Maine, 
New  Hampshire,  and  Vermont: 

•  Hit  the  right  arrow  key  until  you  are  in  the  "Location”  box. 

•  Hit  the  down  arrow  key  to  select  "By  State.” 

•  Hit  "Enter”  and  a  list  of  states  replaces  the  "Location”  box. 

Your  screen  should  now  look  like  Figure  A-7.  The  list  of  states  operates  much  like 
the  other  box  selection  criteria  except  that  it  is  longer.  Experiment  now  with  the 
arrow  keys  and  the  "PgUp,”  "PgDn,”  "Home,”  and  "End”  keys  to  scroll  through  the 
list  of  states.  Once  you  are  comfortable  with  scrolling,  proceed: 


•  Position  to  "ME  Maine”  in  the  list  and  hit  "Enter.” 
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FIG.  A-7.  SELECTION  FROM  STATE  LIST 


Notice  that  as  you  hit  "Enter,”  the  entry  for  "ME  Maine”  disappears  (it  has  moved  to 
the  top  of  the  list  with  a  checkmark)  and  you  are  now  positioned  at  the  next  state  in 
the  alphabet  after  Maine,  "MI  Michigan.”  In  the  location  menus  that  take  up  more 
than  one  screen  (state  and  three-digit  zip  code),  the  selected  items  are  always  shown 
at  the  top  of  the  list. 

Now  move  to  the  entries  for  New  Hampshire  and  Vermont  and  select  them. 
Then  hit  "Home”  and  your  screen  should  look  like  Figure  A-8.  If  you  accidentally 
make  an  incorrect  selection  (say  you  accidentally  selected  Michigan  instead  of 
Maine),  you  can  turn  the  selection  off  by  moving  to  the  selected  item  and  hitting 
"Enter.”  In  other  words,  hitting  "Enter”  checks  a  selection  that  is  not  checked  and 
"unchecks”  a  selection  that  is  checked. 
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FIG.  A-8.  SELECTION  SCREEN  WITH  MAINE,  NEW  HAMPSHIRE, 
AND  VERMONT  SELECTED 


Since  you  now  have  selected  criteria  for  all  the  boxes,  you  can  now  generate  the 
report.  Note  that  the  "Valid  Keys”  box  at  the  bottom  shows  the  keys  you  can  hit  to 
produce  various  results.  Now  hit  the  "F9”  key  to  generate  the  report.  Figure  A-9 
shows  the  resulting  report. 
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FIG.  A-9.  SAMPLE  REPORT  FOR  MAINE,  NEW  HAMPSHIRE,  AND 

VERMONT 
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Lesson  4:  Report  Options 

From  the  report  screen  shown  in  Figure  A-9,  you  can  browse  through  the  list  of 
items  using  the  following  keys: 

•  Down  and  up  arrows  move  through  the  items  one  at  a  time. 

•  Right  and  left  arrows  move  across  the  fields  of  the  report. 

•  "PgUp”  and  "PgDn”  move  up  and  down  one  page  at  a  time. 

•  "Ctrl-PgUp”  and  "Ctrl-PgDn”  move  to  the  first  or  last  record  of  the  report. 

•  Enter  brings  up  a  display  of  details  on  the  current  item. 

•  "FI”  brings  up  a  list  of  other  options. 

Now  hit  "FI”  for  the  list  of  report  options  available.  You  will  see  the  screen  in 
Figure  A-10  which  lists  the  available  keys.  These  options  are  described  in  subse¬ 
quent  sections.  Hit  any  key  to  return  to  the  report. 
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FIG.  A-10.  REPORT  OPTIONS 


Now,  from  the  report  in  Figure  A-9  for  Maine,  New  Hampshire,  and  Vermont, 
produce  a  detail  popup  for  the  unit  whose  unit  identification  code  (UIC)  is  FF2K8. 
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•  Position  the  cursor  to  the  record  for  FF2K8  (the  first  unit  shown)  using  the 
arrow  keys . 

•  Hit  "Enter”  to  show  the  popup  shown  in  Figure  A-ll. 

•  Hit  any  key  to  return  to  the  report. 
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FIG.A-11.  REPORT  DETAIL  POPUP 


Lessofi  5:  Sorting  and  Printing  a  Report 

As  shown  in  Figure  A-10,  you  can  sort  the  report  by  hitting  "F4.”  If  you  have 
the  "Valid  Keys”  screen  showing,  hit  any  key  to  make  it  disappear.  Now  sort  the 
output  by  state  and  zip  code  as  follows: 

•  Hit  "F4”  to  make  the  sort  popup  appear  (Figure  A-12). 

•  Hit  the  down  arrow  key  until  the  "State,  Zip  Code”  item  is  highlighted. 

•  Hit  "Enter”  and  the  report  will  be  sorted  by  state  and  zip  code. 
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FIG.A-12.  SORT  POPUP 


To  print  a  report,  the  printer  should  be  on  and  connected  to  the  personal 
computer  (PC).  The  currently  displayed  report  can  be  printed  by  hitting  "F5.” 

Lesson  6:  Exiting  the  Report  and  Producing  a  New  One 
by  Three-Digit  Zip  Code 

To  exit  the  report,  hit  the  "Esc”  (escape)  key.  This  will  produce  a  popup  as 
shown  in  Figure  A- 13.  If  you  wish  to  exit  the  report  and  return  to  the  selection 
process,  hit  "Enter”  for  "Exit  for  System.”  Otherwise,  you  could  hit  the  down  arrow 
key  to  choose  "Return  to  System”  and  you  would  return  to  the  report  display  process. 
At  this  point,  you  change  your  selection  criteria  to  produce  another  report. 
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FIG.  A-13.  POPUP  FOR  EXITING  THE  REPORT 


Move  to  the  "State”  box  and  hit  "Esc.”  This  will  restore  the  main  "Location” 
box.  Move  to  "By  3-Dig  Zip”  and  hit  "Enter.”  Then  select  three-digit  zip  codes  040 
and  041  by  moving  in  the  window  with  the  cursor  keys  and  hit  "Enter.”  Hit  the 
"Home”  key  when  you  are  finished  and  notice  that  the  two  three-digit  zip  codes  you 
have  selected  have  moved  to  the  top  of  the  list.  You  can  change  these  selections  by 
positioning  on  them  and  hitting  return.  Experiment  with  the  process  of  making  and 
changing  the  selection. 

After  you  have  selected  040  and  041,  hit  "F9”  to  produce  the  report. 

Lesson  7:  Exiting  the  System 

You  can  exit  the  system  from  either  the  report  display  or  the  selection  process 
by  hitting  "F10.”  That  produces  the  screen  shown  in  Figure  A-14.  You  can  then 
return  to  processing  by  hitting  the  down  arrow  and  enter,  or  you  can  exit  by  simply 
hitting  "Enter.” 
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FIG.  A-14.  POPUP  FOR  EXITING  THE  SYSTEM 


Lesson  8:  Selecting  by  Zip  Code  and  Radius 

You  can  limit  the  set  of  units  available  for  selection  to  a  given  radius  around  a 
zip  code.  Suppose  you  want  to  know  all  the  units  within  150  miles  of  St.  Paul, 
Minnesota,  (zip  code  55117).  Re-enter  the  system  and  select  "All  Units,”  "All 
Components,”  and  "All  Corps”  following  the  procedures  that  you  learned  in  Lessons  1 
and  2.  Then  move  to  the  "Location”  box  and  select  "By  Zip  Radius.”  You  should  see  a 
screen  like  the  one  shown  in  Figure  A-15. 

•  Type  the  zip  code  "55117”  and  hit  "Enter.”  While  this  is  a  valid  zip  code, 
there  are  no  units  at  that  zip  code  so  the  system  does  not  recognize  it.  Note 
the  message  at  the  bottom  of  the  screen: 

'Invalid  zip  code;  55113  and  55155  are  nearby” 

Those  zip  codes  are  the  two  closest  ones  (in  sequence)  to  "55117.” 

•  Type  "55113”  (which  you  learned  from  the  message  at  the  bottom  of  the 
screen)  and  hit  "Enter.” 

•  Type  "150”  and  hit  "Enter.” 

•  Hit  "F9”  to  produce  the  report. 
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FIG.  A-15.  ZIP-RADIUS  SELECTION  SCREEN 


Lesson  9:  Limiting  Units  by  Other  Than  Location 

The  "Unit  Type,”  "Component,”  and  "Corps”  selection  criteria  allow  you  to  limit 
the  types  of  units  you  wish  to  include  in  a  selection.  You  can  select  one  or  more 
criteria  by  moving  to  the  appropriate  box,  highlighting  the  item,  and  hitting  "Enter.” 
You  can  change  any  selection  that  has  been  chosen  by  highlighting  the  item  and 
hitting  "Enter.” 

The  "All . . .”  selection  items  are  mutually  exclusive  with  others.  For  example, 
if  you  have  any  corps  selected  and  you  select  "All  Personnel,”  then  the  individual 
corps  selection  will  be  changed  as  you  select  "All  Personnel.”  You  should  experiment 
with  the  selection  criteria  to  determine  the  impact  of  selecting  each  item. 

Lesson  10:  Producing  a  Specialty  Report 

The  specialty  report  lists  all  officer,  warrant  officer,  and  enlisted  specialties 
that  exist  in  a  single  unit  or  group  of  units.  The  report  shows  the  specialty  code,  title, 
and  number  of  people  assigned  to  each  specialty  (see  Figure  A- 16). 
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FIG.A-16.  SPECIALTY  REPORT 


To  produce  this  report  for  a  group  of  units  —  for  example,  the  group  produced  in 
Lesson  8  -  press  the  "F8”  key.  To  generate  this  report  for  a  specific  unit,  position  the 
cursor  to  the  desired  unit  and  press  "Enter.”  A  popup  summary  for  that  unit  appears 
(see  Figure  A-ll).  Press  the  "Enter”  key  again.  A  window  appears;  select  "Specialty 
Report”  and  press  "Enter.” 

To  exit  from  the  specialty  report,  press  the  "Esc”  key. 

Lesson  1 1 ;  Gateway  to  Maplnfo 

Now  reproduce  the  report  in  Lessons  1  through  4  for  Maine,  New  Hampshire, 
and  Vermont  and  hit  "F6”  to  enter  Maplnfo.  As  it  begins,  Maplnfo  will  first  align  the 
map  to  the  set  of  points  you  have  selected.  As  it  does  so,  the  screen  shown  in 
Figure  A- 17  will  be  displayed.  If  a  large  number  of  units  is  included  in  the  report, 
this  step  may  take  a  long  time. 
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FIG.  A-17.  MAPINFO  INITIALIZATION  SCREEN 


Once  this  step  is  complete,  the  screen  should  show  a  map  that  is  scaled  to  the 
points  that  you  have  selected  in  your  report  as  shown  in  Figure  A- 18.  The  key  to  this 
display  is  as  follows: 

•  Red  lines  are  state  boundaries. 

•  Dotted  red  lines  are  three-digit  zip  code  boundaries  (those  lines  are  labeled 
in  italics). 

•  White  lines  with  labels  are  interstate  highways. 

•  Light  blue  squares  are  major  cities  (these  cities  may  or  may  not  be  labeled 
depending  on  whether  enough  space  is  available). 

•  Light  green  stars  represent  locations  with  one  or  more  Army  units. 

•  White  anchors  represent  locations  with  one  or  more  Navy  units. 

•  Blue  jets  represent  locations  with  one  or  more  Air  Force  units. 

Note  that  stars,  anchors,  and  jets  may  be  displayed  at  the  same  point. 


A- 16 


FIG.  A-18.  MAP  OF  UNITS  IN  MAINE,  NEW  HAMPSHIRE.  AND 

VERMONT 


Lesson  12:  Navigating  Maplnfo  Menus 

The  screen  shown  in  Figure  A-18  contains  the  options  for  the  main  menu  of  the 
mapping  portion  of  the  system.  Note  the  arrow  cursor  pointing  to  the  first  item, 
"Find,”  which  is  in  reverse  video.  The  down  and  up  arrow  keys  change  the  currently 
selected  item.  The  text  in  the  lower  left  corner  of  the  screen  ("Locate  a  unit,  zip,  or 
three-digit  zip  boundary”)  describes  the  function  of  the  currently  selected  option. 
Move  through  the  selected  items  by  hitting  the  up  and  down  arrow  keys  and  notice 
how  the  text  changes.  (If  you  move  past  the  last  item,  hit  the  up  arrow  key  to  return 
to  the  menu.) 

When  working  with  the  main  menu,  you  can  select  the  currently  highlighted 
item  by  hitting  return.  Move  the  cursor  to  the  item  "North”  and  hit  return  and  the 
map  will  move  one-half  screen  to  the  north;  do  the  same  with  "South,”  "East,”  and 
'"West.”  This  process  should  leave  the  map  where  it  was  when  you  started.  Note  that 
as  you  panned  to  the  surrounding  area,  there  were  no  units  (stars,  anchors,  and  jets). 
This  is  because  the  map  only  shows  the  units  that  you  selected  in  your  report. 

Lesson  13:  Finding  a  Unit 

The  "Find”  option  of  the  main  menu  allows  you  to  locate  points  on  the  map  by 
certain  attributes  (unit  identifier,  zip  code,  or  three-digit  zip  code  boundary).  Move 
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the  main  menu  pointer  to  select  "Find”  and  hit  "Enter.”  A  new  menu  will  now  appear 
in  the  upper  left  corner  as  shown  in  Figure  A- 19.  This  menu  operates  like  the  main 
menu.  You  can  move  it  up  and  down  to  highlight  an  item  and  select  with  the  "Enter” 
key. 


Now  select  the  "Unit”  options  and  a  popup  will  appear  as  shown  in  Figure  A-20. 
Type  "0157  USAF  Clinic”  and  hit  '’Enter.”  A  large  arrow  points  to  that  unit  as  shown 
in  Figure  A-21.  If  the  UIC  does  not  exactly  match  the  name  of  a  unit  that  has  been 
selected,  a  list  of  close  matches  appears  on  the  screen.  You  can  select  one  from  the  list 
by  highlighting  it  and  hitting  "Enter.” 
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Locate 


FIG.A-20.  POPUP  FOR  FINDING  A  UNIT 


FIG.A-21.  ARROW  SHOWING  UNIT  LOCATION 


Finding  a  three-  or  five-digit  zip  code  uses  the  same  approach:  select  the  "Zip3 
or  "Zip5”  option  and  type  in  the  zip  you  wish  to  find. 


Lesson  14:  Labeling  Units 


Now  you  will  see  cross  hairs  pointing  to  the  center  of  the  map.  You  can  move 
those  cross  hairs  to  any  point  on  the  map  with  the  cursor  keys.  Move  the  cross  hairs 
to  one  of  the  unit  points  on  the  screen  and  hit  "Enter.”  At  this  point,  one  of  three 
results  can  occur:1 

•  If  only  one  unit  exists  at  the  point  and  Maplnfo  can  find  room  to  put  its  label, 
the  label  will  appear  on  the  map. 

•  If  only  one  unit  exists  and  Maplnfo  cannot  find  room  to  put  its  label,  the 
label  will  not  appear  on  the  map  and  Maplnfo  will  issue  a  message. 

•  If  more  than  one  unit  exists  at  the  point,  a  popup  will  appear  showing  the  list 
of  units  from  which  you  can  select  the  one  to  label.  If  there  is  not  enough 
room  for  the  label,  the  label  will  not  appear  on  the  map  and  Maplnfo  will 
issue  a  message. 


Select  taUpoint 


FIG.  A-22.  CROSS  HAIRS  IN  LOCATION  SELECTION 


lYou  can  control  how  far  the  cross  hairs  move  each  time  you  hit  the  arrow  keys  by  hitting  the 
numbers  1  through  9.  Hitting  "1”  will  cause  the  arrow  keys  to  move  the  cross  hairs  only  a  very  small 
amount;  "9”  will  move  them  much  more,  and  "4”  is  the  default  and  should  be  used  when  selecting 
menu  items. 
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For  three  reasons,  there  may  not  be  enough  space  to  place  a  label  on  the  map: 

•  Only  two  labels  may  be  assigned  to  the  same  point.  If  more  than  two  units 
are  at  the  same  point,  then  only  two  of  the  units’  labels  can  appear  there. 

•  There  may  not  be  enough  room  between  the  point  and  the  margin  of  the  map 
to  fit  the  label  (see  Lesson  18:  Panning,  to  change  the  center  of  the  map  to 
allow  for  more  room). 

•  Other  labels  for  other  map  objects  (cities,  highways,  etc.)  may  be  in  the  way. 
They  can  be  cleared  with  the  "ToggleOther”  option,  which  turns  labeling  on 
and  off  for  all  the  labeled  items.  Use  it  as  follows: 

t  Highlight  "ToggleOther”  and  hit  "Enter.”  This  will  cause  the  map  to  be 
redrawn  without  any  labels  except  unit  labels. 

>  Label  the  units  you  wish  to  label. 

►  Highlight  "ToggleOther”  and  hit  "Enter”  to  make  all  other  labels  that 
will  fit  reappear. 

You  can  clear  the  unit  labels  that  you  have  plotted  with  the  "ClearUnits”  option.  In 
order  to  leave  the  labeling  process  and  return  to  the  main  menu,  hit  "Esc.” 

Lesson  15:  Displaying  Data 

You  can  display  the  data  corresponding  to  a  point  by  selecting  the  "Data”  option 
of  the  main  menu  (highlight  "Data”  and  hit  "Enter”).  Proceed  as  follows: 

•  Maplnfo  will  display  cross  hairs,  which  you  position  to  the  data  point  to  be 
displayed.  Move  the  cross  hairs  to  the  point  whose  data  you  wish  to  display 
and  hit  "Enter.” 

•  Maplnfo  will  display  a  large  arrow  and  ask  you  to  confirm  your  point 
selection.  Hit  "Enter”  to  confirm  the  selection  or  "Esc”  to  try  again  with  the 
cross  hairs. 

•  If  more  than  one  unit  is  located  at  the  point,  a  popup  will  appear  showing  the 
list  of  units  from  which  you  can  select  the  one  you  wish  to  see.  Navigate 
through  this  list  by  using  your  arrow  keys.  Place  the  arrow  at  the  unit  you 
choose  and  press  "Enter.”  More  units  may  be  located  at  the  point  than  can 
be  displayed  in  the  popup  on  the  screen.  If  so,  you  can  view  the  complete  list 
by  hitting  the  "PgUp”  and  "PgDn”  keys. 

Press  "Esc”  to  return  to  the  main  menu. 
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Lesson  16:  Changing  the  Zoom 

You  can  change  the  area  displayed  while  maintaining  the  same  center  point,  by 
selecting  the  "Zoom”  option: 

•  Select  "Zoom”  from  the  main  menu  (highlight  "Zoom”  and  hit  "Enter”). 

•  Type  the  new  zoom  value  in  miles  and  hit  "Enter”  and  Maplnfo  will  redraw 
the  map. 

Zooming  in  and  out  on  the  map  can  cause  more  and  less  detail  to  appear. 
Zooming  out  to  beyond  100  miles  (101  miles  or  more)  makes  only  large  cities  appear 
on  the  map.  Zooming  out  lo  beyond  300  miles  makes  the  three-digit  zip  code 
boundaries  disappear  Zooming  out  to  beyond  500  miles  makes  even  the  large  cities 
disappear. 

Note  that  if  you  have  any  units  labeled  on  your  map,  the  labels  will  be  resized 
proportionally  to  the  change  in  the  zoom.  Those  labels  can  be  removed  and  replaced 
using  the  "Label”  option  of  the  main  menu  (see  Lesson  14:  Labeling  Units). 

Lesson  17:  Magnifying  an  Area 

You  can  magnify  parts  of  the  map  with  the  "Magnify”  option.  It  allows  you 
select  a  rectangle  to  magnify  with  the  cross  hairs.  Follow  these  steps  to  select 
magnify: 

•  Move  the  cross  hairs  to  one  corner  of  the  area  to  magnify  and  hit  "Enter.” 

Move  the  cross  hairs  to  the  other  corner  and  hit  "Enter”  and  the  map  is 
redisplayed. 

At  any  step  along  the  way,  you  can  hit  "Esc”  to  back  up  to  the  previous  steps. 

Lesson  18:  Panning 

You  can  pan  through  the  map  by  selecting  the  "North,”  "South,”  "East,”  "West,” 
and  "Center”  options  of  the  main  menu.  The  direction  options  move  the  map  one-half 
screen  in  the  selected  direction.  The  "Center”  option  displays  cross  hairs  to  allow  you 
to  define  a  point  to  be  the  center  of  the  map.  Move  the  cross  hairs  to  the  point  you 
wish  to  be  the  center,  hit  "Enter,”  and  Maplnfo  will  redraw  the  map. 
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Lesson  19:  Printing 

If  you  have  a  graphics  printer,  you  can  print  the  map  you  are  currently  viewing. 

Select  the  "Print”  option  from  the  main  menu  and  proceed  as  follows: 

•  The  initial  screen  is  shown  in  Figure  A-23.  This  allows  you  to  control 
options  in  the  printing  of  your  map.  You  will  not  normally  want  to  change 
this  screen.  To  control  these  options  see  your  Maplnfo  users  guide.  Other¬ 
wise,  simply  hit  "Enter.” 

•  Next  you  will  see  a  screen  similar  to  that  shown  in  Figure  A-24  that  allows 
you  to  select  the  area  to  be  printed.  A  page-shaped  box  is  superimposed  on 
your  screen  which  you  can  move  with  the  cursor  keys  to  select  the  area  you 
wish  to  print. 


FIG.  A-23.  PRINT  OPTIONS  SCREEN 


FIG.A-24.  PRINT  AREA  SELECTION 
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ANNEX 


DISPLAY,  PRINTER,  AND  PLOTTER  DEVICES  SUPPORTED 

BY  MAPINFO 


Geographic  output  on  the  display  or  in  hard  copy  with  Maplnfo  (Version  4.0) 
can  support  the  following  devices: 

•  Display  devices: 

►  AT&T  6300  Monochrome 

►  AT&T  6300  Color 

►  Compaq  Portable  EH 

►  CGI  Driver  for  DGIS  Devices 
t  Hercules  InColor 

i  Hercules  Monochrome  Adapter 
t  High  Resolution  Enhanced  Graphics  Adapter  (EGA) 

►  IBM  8514/A 

►  IBM  8541/A 

t  IBM  Color  Graphics  Adapter  —  High  Resolution  Monochrome 

►  IBM  EGA 

►  IBM  PS/2  Mode  11  (VGA) 

►  IBM  PS/2  Mode  12  (VGA) 

►  IBM  MGA/VGA  Mode  13 

►  Toshiba  3100 

•  Printers  and  plotters: 

►  Calcomp  Ext  960  Plotters 

t  Cannon  Laser  Beam  Printer  813 

►  Diconix  Low  Resolution  Inkjet  Printer 

►  Diconix  High  Resolution  Inkjet  Printer 

►  Epson  LQ  Series  Printers 

t  Epson  LQ  Series  Color  Printers 

►  Epson  X 

►  Hewlett  Packard  DeskJet 

►  Hewlett  Packard  LaserJet  4- 

►  Hewlett  Packard  Paintjet  (180  or  90  dpi) 
t  Hewlett  Packard  Plotters 

t  Hewlett  Packard  Quietjet  Printer 
t  Hewlett  Packard  Thinkjet  Printer 
t  HPGL  Output  Only  Plotters 
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►  Houston  Instrument  Plotters 

►  IBM  Color  Graphics  Printer 
t  IBM  Graphics  Printer 

t  IBM  Proprinter 

►  IBM  Proprinter  13 

►  IBM  Proprinter  XL24 

►  IBM  Quietwriter  II 
t  IBM  Quietwriter  3 

►  NEC  Pinwriter  P5 

►  NEC  Pinwriter  P5XL 

►  Okidata  290-Series  Printer 

►  PostScript  Printers 

►  Roland  DG  Plotters 

k  Tektronix  4695/4696  Color  Printer 
t  Toshiba  Printer 

►  Versatec  Printer 

Refer  to  the  Maplnfo  Command  Reference,  Appendix  A,  for  details  on  installation  of 
the  device  drivers  and  options  for  these  devices. 
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APPENDIX  B 


THE  DIRECTORY  OF  SELECTED  RESERVE  MEDICAL  PERSONNEL 

MAINTENANCE  MANUAL 


SYSTEM  OVERVIEW 

The  system  was  designed  to  run  on  an  IBM-compatible  80286-based  system 
with  640K  of  random  access  memory  (RAM)  and  14  megabytes  of  disk  storage. 
Performance  is  significantly  enhanced  when  run  on  an  80386  system  with  a  fast  disk 
drive.  It  was  developed  in  Clipper,  Summer  1987  Version  (Nantucket  Corporation, 
Los  Angeles,  California)  to  use  data  files  that  can  be  maintained  in  FoxBASE  +  or 
dBASE.  (Indexes  must  be  produced  in  Clipper.)  The  mapping  portion  of  the 
system  was  developed  with  Maplnfo  Version  4.0,  MapCode,  and  the  MapPack 
Sampler  (MAPINFO  Corporation,  Troy,  New  York);  and  Switch-It  Version  1.00 
(Black  &  White  International,  Inc.,  New  York,  New  York)  to  free  memory  for  the 
mapping  session. 

The  main  program  resides  in  the  root  directory  for  Maplnfo  (described  in 
Figure  B-l)  with  data  base  files  in  the  DBF  subdirectory.  Source  code  is  located  in 
the  subdirectory  PRG  and  the  data  aggregation  program  and  inventory  and  unit 
address  files  are  in  the  subdirectory  AGGREG.  Maplnfo  cannot  be  installed  by 
copying  the  diskettes  onto  a  hard  disk  drive.  Annex  1  presents  the  Maplnfo  instal¬ 
lation  procedures. 

MODULE  STRUCTURE 

The  main  module  of  the  system  MAIN  .PRG  calls  the  system  initialization 
module  INITENV.PRG,  which  defines  system  parameters  such  as  screen  colors. 
MAIN.PRG  then  calls  MENUS.PRG.  This  program  loads  the  lists  of  choices  for  each 
selection  criterion  into  arrays.  MAIN.PRG  then  calls  MENUS.PRG  which  waits  for 
keystrokes  during  selection  criteria  processing  and  handles  the  operation  of  the 
selection  criteria  choice  lists. 

MENUS.PRG  calls  one  of  the  generalized  list  selection  programs 
(MENUSLCT.PRG,  MEN2SLCT.PRG,  or  LMENSLCT.PRG)  to  control  the  selection 
process.  An  action  initiated  from  one  of  these  programs  is  handled  in  one  of  three 
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a  System  function,  not  a  separate  module 


FIG.B-1.  SYSTEM  MODULE  STRUCTURE 

modules:  the  MENUEXCP  function  (called  by  the  Clipper  ACHOICE  function),  the 
generalized  list  selection  program  itself,  or  MENUKEYS.PRG,  which  is  called  by  the 
generalized  list  selection  program  to  handle  certain  keystrokes.  MENUS.PRG  calls 
MENUSCRN.PRG  to  repaint  the  screen  when  necessary. 

If  the  key  to  generate  a  report  is  pressed,  the  generalized  list  selection  program 
being  executed  calls  MENUKEYS.PRG,  which  then  calls  GENREPT.PRG.  That 
module,  which  controls  the  preparation  and  displaying  of  reports,  first  calls 
BLDFILTR.PRG,  which  copies  MASTDB.DBF  records  to  a  temporary  report  data 
base,  filtering  with  the  requested  selection  criteria.  The  data  base  is  then  displayed 
using  the  Clipper  DBEDIT  function. 

The  module  FUNCTNS.PRG  contains  various  functions,  the  most  significant  of 
which  is  RPTEXCP.  DBEDIT  calls  RPTEXCP  whenever  a  special  action  key  (such  as 
the  report  sort  key,  print  key,  or  escape  key)  is  pressed  while  viewing  the  report. 
When  a  sort  is  requested,  RPTEXCP  calls  RPTSORT.PRG.  When  print  is  requested, 
PRINTRPT. PRG  is  called.  Figure  B-l  shows  the  structure  of  the  system  modules. 
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SYSTEM  FILES 


In  order  to  run  the  system,  MAIN.EXE  must  be  present  in  Maplnfo’s  root 
directory  in  addition  to  the  Maplnfo  files  and  the  DBF  subdirectory  must  contain  the 
following  files: 

COMPOS. DBF  Component  selection  list  items 

CORPS. DBF  Corps  selection  list  items 

LOCTYPES.DBF  Items  for  the  location  selection  types  list 

MASTDB.DBF  Unit  data  base  used  by  the  system;  described  in  Annex  2 

RPTSTRUC.DBF  Report  fields  to  be  displayed  by  DBEDIT 

SORTFLDS.DBF  Field  combinations  to  sort  on  and  contains  sort  menu 
entries 

STATES. DBF  State  selection  list  items 
TEMPLATE.DBF  Field  structure  of  MASTDB 
UNITTPS.DBF  Medical/nonmedical  selection  list  items 
ZEP1.DBF  One-digit  zip  code  selection  list  items 

ZIP3.DBF  Three-digit  zip  code  selection  list  items 

STATE.NTX  Index  on  the  STATE  field  in  MASTDB.DBF 
ZIP.NTX  Index  on  the  ZIP  field  in  MASTDB.DBF 

UIC.CNF  Maplnfo  configuration  file 

UIC.APP  MapCode  application  file 

MAPINFO.PER  Tailored  Maplnfo  "personality”  file  (replaces  Maplnfo- 
provided  version) 

SYMBOLS.TXT  Modified  symbols  file  (replaces  Maplnfo-provided  version). 

Names  or  order  of  choice  items  in  a  selection  list  can  be  changed  by  modifying  or 
altering  the  order  of  records  in  the  data  base  used  to  generate  that  list.  The  order  of 
items  in  the  main  location  selection  list  (e.g.,  All  Locations,  By  State,  etc.)  should  not 
be  altered  because  the  source  code  will  need  to  be  altered  throughout  the  system. 

The  appearance  of  a  displayed  report  can  be  altered  by  modifying  the  fields  in 
RPTSTRUC.DBF.  A  record,  which  describes  a  report  column,  can  be  added  or  deleted 
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to  include  or  exclude  a  MASTDB  field  from  the  report.  Records  can  also  be  modified 
to  adjust  report  column  widths  and  column  headings.  The  total  width  of  the  report, 
however,  should  not  exceed  80  columns. 

A  new  combination  of  sort  fields  can  be  added  by  modifying  SORTFLDS.DBF, 
which  is  used  to  display  the  sort  options  menu  and  contains  the  names  of  the  fields  on 
which  to  sort.  In  some  cases,  such  as  when  a  new  sort  needs  to  be  in  descending  order, 
the  jlPTSORT.PRG  modules  will  also  need  to  be  changed. 

The  MASTDB. DBF  file  and  the  two  index  files  STATE. NTX  and  ZIP.NTX  are 
maintained  by  the  data  aggregation  program.  If  MASTDB  is  altered,  the  indexes 
should  be  rebuilt  by  running  REINDEX  (see  "Reindexing  the  Data  Base  Files”).  If 
location  (e.g.,  the  STATE  or  ZIP  field)  data  are  changed,  the  affected  MASTDB 
records  will  need  to  be  geocoded  (see  "Geocoding  the  Master  System  Data  Base”  in 
this  appendix)  and  ZIPDIST.DBF  will  need  to  be  regenerated  (see  "Creating  the 
ZEPDIST  File”  in  this  appendix)  prior  to  REINDEX  being  run. 

DATA  PREPARATION 


This  section  describes  the  utility  programs  and  procedures  for  creating  and 
maintaining  the  system  data  files. 


Data  Aggregation 


The  aggregation  of  inventory  data  to  create  MASTDB.DBF  is  performed  by  the 
program  AGGREG  with  no  command  line  parameters.  In  order  to  perform  the 
aggregation,  the  following  files  must  be  present  in  the  AGGREG  subdirectory: 


AGGREG.EXE 

AF.DBF 
ARMY. DBF 
NAVY. DBF 
RA.UBF 


Main  aggregation  program;  compiled  from  AGGREG.PRG 
in  same  directory 

New  Air  Force  inventory  data 

New  Army  inventory  data 

New  Navy  inventory  data 

File  ol  all  available  unit  addresses. 


In  addition,  MASTDB.DBF,  STATES. DBF,  and  ZEP3.DBF  must  be  present  in  the 
system  root  directory.  Descriptions  of  the  inventory  file  structures  appear  in 
Annex  3. 
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Upon  the  successful  completion  of  the  aggregation  program,  the  following  files 
will  have  been  created  in  the  AGGREG  subdirectory: 

MASTDB.DBF  New  file;  does  not  affect  version  in  DBF  subdirectory 

STATES.DBF  Updated  if  necessary;  leaves  version  in  DBF  subdirectory 
undisturbed 

ZIP3.DBF  Updated  if  necessary;  leaves  version  in  DBF  subdirectory 

’  undisturbed 

STATE. NTX  New  file;  does  not  affect  version  in  DBF  subdirectory 

ZIP3.NTX  New  file;  does  not  affect  version  in  DBF  subdirectory 

AFPROB.DBF  (Conditional)  AF.DBF  records  whose  unit  identification 
code  (UIC)  does  not  match  a  UIC  in  RA.DBF  or  whose  Duty 
Air  Force  Specialty  Code  (DAFSC)  does  not  fit  into  one  of 
the  defined  corps 

ARMYPROB.DBF  (Conditional)  ARMY. DBF  records  whose  UIC  does  not 
match  a  UIC  in  RA.DBF  or  whose  Duty  Military  Occupa¬ 
tional  Specialty  (DMOS)  does  not  fit  into  one  of  the  defined 
corps 

NAVYPROB.DBF  (Conditional)  NAVY.DBF  records  whose  UIC  does  not 
match  a  UIC  in  RA.DBF  or  whose  designator  does  not 
match  one  of  the  defined  corps. 

New  records  are  added  to  the  end  of  STATE.DBF  and  ZIP3.DBF  for  va.ues  not 
already  in  these  files.  They  should  be  examined,  and  unwanted  values,  such  as 
STATE  =  "  ”  should  be  deleted.  Names  should  be  added  to  the  new  state  abbrevia¬ 
tions  in  STATE.DBF.  Finally,  these  files  should  be  sorted  and  copied  into  the  DBF 
subdirectory. 

MASTDB.DBF  is  created  from  scratch  each  time  AGGREG  is  run.  Changes 
made  manually  to  address  data  in  MASTDB  must  also  be  made  to  the  master  unit 
address  file  RA.DBF  in  order  for  the  changes  to  appear  in  future  versions  of 
MASTDB. 

Geocoding  the  Master  System  Data  Base 

Once  the  master  file  is  created,  it  must  be  geocoded  to  determine  the  longitude 
and  latitude  values  based  on  the  zip  code  for  each  record.  It  is  geocoded  by  using  the 
Maplnfo  geocoding  capabilities  described  in  the  Maplnfo  users  guide.  First,  the 
majority  of  the  MASTDB  records  can  be  geocoded  by  zip  code.  Units  in  Puerto  Rico 
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should  be  geocoded  by  state  and  the  remainder  (Guam  and  the  Virgin  Islands)  can  be 
geocoded  by  pointing. 

When  a  previously  geocoded  MASTDB  file  has  had  changes  made  to  the  STATE 
or  ZIP  fields  of  some  records,  the  XCOORD  and  YCOORD  fields  of  those  records  must 
be  replaced  with  -1.  Records  with  positive  values  in  those  fields  will  not  be  geocoded 
again. 

Creating  the  ZIPDIST  File 

In  order  to  perform  zip-radius  selections,  the  ZIPDIST. DBF  file  must  be 
recreated  and  indexed  each  time  a  new  version  of  MASTDB. DBF  is  generated  or 
modified.  MASTDB. DBF,  ZIPDIST.BAT,  ZD.EXE,  and  ZIPDISTB.DB  must  be 
present  in  the  AGGREG  subdirectory,  where  ZIPDIST. DB  will  be  generated. 

First,  import  the  MASTDB. DBF  file  created  by  the  data  aggregation  process 
described  above  into  the  Paradox  file  MASTDB. DB  (Tools,  Exportlmport,  Import, 
2)  dBASE  HI).  Then  run  a  Paradox  query  (Ask)  on  MASTDB,  checking  (F6)  the  fields 
ZIP,  XCOORD,  and  YCOORD.  When  the  query  has  finished  processing,  rename  the 
answer  file  ANSWER  to  ZIPDB  (Tools,  Rename,  File).  Delete  ZIPDB  records  with  a 
blank  ZIP  field  or  with  XCOORD  or  YCOORD  =  -1,  and  then  exit  Paradox.  Then 
run  the  batch  file  ZIPDIST.BAT  (which  runs  ZD.EXE)  which  will  produce  the 
Paradox  file  ZEPDIST.DB.  This  takes  several  hours  to  run.  At  the  conclusion, 
re-enter  Paradox  and  export  the  file  ZIPDIST.DB  in  dBASE  format  to  the  file 
ZEPDIST.DBF  (Tools,  Exportlmport,  Export,  2)  dBASE  DI). 

At  this  point,  the  Paradox  files  used  for  this  step,  ZEPDB.DB,  MASTDB. DB,  and 
ZIPDIST.DB,  can  be  deleted,  and  the  new  files  created  in  the  AGGREG  subdirectory 
can  replace  the  older  versions  of  the  same  files  in  the  DBF  directory. 

Reindexing  the  Data  Base  Files 

The  REINDEX  program,  located  in  the  DBF  subdirectory,  generates  all  of  the 
system  indexes.  This  program  should  be  run  after  creating  ZIPDIST. DBF  and  any 
time  a  data  file  is  changed. 
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INSTALLING  MAPINFO 


Maplnfo  should  be  installed  in  the  root  directory  used  for  the  system.  During 
installation,  the  MapPack  sampler  should  be  installed.  After  installation,  the 
SYMBOLS.IN  file  should  be  copied  into  the  root  directory.  Maplnfo  should  then  be 
run  with  "File  Utilities”  selected  from  the  main  menu.  Then,  the  following  menu 
items  should  be  chosen  in  sequence: 

•  Generate  vector  fonts 

•  Yes  (directory  in  which  import  file  is  located) 

•  SYMBOLS.IN  (select  file  to  import) 

•  Yes  (directory  in  which  to  .create  font  file) 

•  •  Enter  (enter  font  file  root  name) 

•  -4-J  Enter  (confirm  that  SYMBOLS.TXT  already  exists  and  should  be 

overwritten). 

Then  exit  Maplnfo. 

Make  sure  the  UIC.APP,  UIC.CNF,  and  MAPINFO.PER  files  are  copied  into 
Maplnfo’s  root  directory  after  Maplnfo  has  been  installed.  This  is  necessary  to  over¬ 
write  Maplnfo’s  version  of  these  files.  The  first  time  Maplnfo  is  run  from  the  system 
(using  the  F6  "Gateway  to  Maplnfo”  key),  it  may  need  to  generate  some  index  files;  it 
may  therefore  be  desirable  to  generate  a  short  report.  Successfully  "zooming  in” 
(using  Maplnfo’s  Zoom  feature)  to  within  5  miles  and  out  to  at  least  101  miles  should 
verify  that  all  files  are  present  and  indexed. 
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FILE  DESCRIPTION  OF  MASTDB.DBF 


field 

— 

Type3 

Bytes 

Description 

RECNUM 

N 

4 

Used  to  show  record  number  being  viewed  when  report  is 
displayed,  determined  by  the  AGGREG.EXE  program 

UIC 

C 

6 

Unit  ID  Code,  from  RA.DBF 

SERVICE 

N 

2 

Code  used  by  Maplnfo  to  display  symbol  for  unit 

(79  Air  Force,  83  Army,  90  Navy)  determined  by  AGGREG 

COMPO 

C 

4 

Reserve  component,  determined  by  AGGREG 

NAME 

C 

30 

Unit  Name,  from  RA.DBF 

STREET 

c 

35 

Local  address  of  unit,  from  RA.DBF 

STREET2 

c 

30 

Continuation  of  local  address,  from  RA.DBF 

CITY 

c 

28 

City,  from  RA.DBF 

ZIP 

c 

5 

Zip  code,  from  RA.DBF 

ZIP2 

c 

4 

Zip  code  extension,  from  RA.DBF 

PHONE 

c 

10 

Phone  number  including  area  code,  from  RA.DBF 

MEDUNIT 

c 

1 

"Y"  or  "N"  for  whether  unit  is  a  medical  unit,  from  RA.DBF 

ENLISTED 

N 

3 

Number  of  medical  enlisted  troops,  calculated  by  AGGREG 

WARRANT 

N 

3 

Number  of  medical  warrant  officers,  calculated  by  AGGREG 

OFFICERS 

N 

3 

Total  number  of  medical  officers,  calculated  by  AGGREG 

MEDICAL 

N 

3 

Number  of  medical  corps,  calculated  by  AGGREG 

NURSE 

N 

3 

Number  of  nurses,  calculated  by  AGGREG 

MEDSPEC 

N 

3 

Number  of  medical  specialists,  calculated  by  AGGREG 

DENTAL 

N 

3 

Number  in  dental  corps,  calculated  by  AGGREG 

VET 

N 

3 

Number  of  veterinarians,  calculated  by  AGGREG 

MEDSERV 

N 

3 

Number  in  medical  services  corps,  calculated  by  AGGREG 

BIOMEDSCI 

N 

3 

Number  of  biomedical  scientists,  calculated  by  AGGREG 

XCOORD 

N 

9 

Longitude  of  unit,  geocoded  by  Maplnfo 

YCOORD 

N 

9 

Latitude  of  unit,  geocoded  by  Maplnfo 

*  N  =  numeric  data,  C  =  alphanumeric  data. 
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REQUIRED  FIELDS  FOR  THE  INVENTORY 
AND  RESERVE  UNIT  ADDRESS  FILES 

AF.CVBF  -  THE  AIR  FORCE  INVENTORY  FILE 

The  Air  Force  inventory  file  is  a  file  of  current  Air  Force  inventory  data.  It 
should  be  created  each  time  new  data  are  to  be  aggregated  into  a  new  version  of 
MASTDB.DBF.  All  fields  should  be  left-justified  character  fields. 

Field  Description 

UIC  Unit  identification  code 

COMP  "5”  Air  Force  Guard,  "6”  Air  Force  Reserve 

GRADE  First  character  is  "0”  Enlisted,  "2”  Officer 

DAFSC  Duty  Air  Force  Specialty  Code;  numeric  code  can  be  preceded  by  an 
alphabetic  character. 

ARMY.DBF  -  THE  ARMY  INVENTORY  FILE 

The  Army  inventory  is  to  be  aggregated  to  a  new  version  of  MASTDB.  All  fields 
should  be  left-justified  character  fields. 

Field  Description 

UIC  Unit  identification  code 

COMP  "1”  Army  Guard,  "2”  Army  Reserve 

GRADE  First  character  is  "0”  Enlisted,  "2”  Officer 

DMOS  Duty  Military  Occupational  Specialty. 

NAVY.DBF  -  THE  NAVY  INVENTOR*  FILE 

The  Navy  inventory  file  is  a  file  of  current  Navy  enlisted  and  officer  inventory 
data.  This  file  should  be  created  each  time  new  data  are  to  be  aggregated  into  a  new 
version  of  MASTDB.  All  fields  should  be  left-justified  character  fields. 
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Field  Description 

UIC  Unit  identification  code 

DESIG  Designator  (job  code). 

RA.DBF  -  THE  RESERVE  UNIT  ADDRESS  FILE 

The  reserve  unit  address  file  is  a  list  of  all  reserve  units  containing  the  address 
data  used  in  MASTDB.DBF.  It  is  not  recreated  for  each  aggregation,  but  rather 
updated  with  new  addresses  of  units  written  to  the  problem  files  (AFPROB.DBF, 
ARMYPROB.DBF,  NAVYPROB.DBF)  during  aggregation.  It  contains  the  fields 
UIC,  NAME,  STREET,  STREET2,  CITY,  STATE,  ZIP,  ZIP2,  PHONE,  and 
MEDUNIT  of  the  same  length  and  type  as  described  for  MASTDB  in  Annex  1. 
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LINKING  THE  SYSTEM  FILES 


The  system  executable  file  MAIN.EXE  was  created  by  compiling  the  Clipper 
modules  and  then  linking  the  object  files  with  the  Microsoft  8086  Object  Linker 
Version  3.05.  Version  3.05  of  the  Microsoft  Object  Linker  is  part  of  DOS  4.0.  The 
Clipper  modules  can  be  compiled  using  the  syntax: 

CLIPPER  <  module _ filename>  -M -Q 

To  link,  create  a  "link  file”  and  invoke  the  linker  as  follows: 

LINK/SE:256  @ <linkfile _ name> 

The  link  file  is  an  American  Standard  Code  for  Information  Interchange 
(ASCII)  file  containing  four  entries.  The  first  entry  lists  the  object  modules  to  be 
linked  (with  optional  path  names)  separated  by  the  plus  sign  ( 4- ).  When  the  list  is 
split  over  multiple  lines,  each  line  except  the  last  must  end  with  a  plus  sign.  The  first 
object  module  listed  must  be  the  HEADER7.0BJ  file  (required  for  Switch-It).  The 
next  entry  of  the  link  file  is  the  name  of  the  executable  file  (with  optional  path  name). 
The  third  entry  contains  a  name  for  a  map  file,  if  desired,  or  blank  for  no  map.  The 
final  line  contains  the  required  Clipper  library  files,  separated  by  spaces.  (Currently 
CLIPPER.LIB  and  EXTEND.LIB  are  needed.) 

The  following  is  an  example  of  a  link  file  (directory  and  drive  names  may  vary 
with  your  configuration): 

ENTRY  I  c:\switchit\header7.obj  4-  main.obj  +  initenv.obj  +  menus. obj  4- 

menuscrn.obj  4-  genrept.obj  +  menukeys.obj  4-menuslct.obj  -I-  lmenslct.obj 
4-  bldfiltr.obj  4-  functns.obj  4-  men2slct.obj  4-  rptsort.obj  4-  printrpt.obj  4- 
ziprad.obj  4-  filter. obj  4-  c:\switchit\switchu7.obj 

ENTRY  2  ...\main.exe 

ENTRY  3 

ENTRY  4  d:\clipper\clipper.libd:\clipper\extend.lib 
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To  create  the  maintenance  programs  AGGREG.EXE  and  REINDEX.EXE. 
they  should  be  compiled  using  the  command  line  described  above.  Although  a  link 
file  could  be  created  as  described  above,  it  is  just  as  easy  for  single-module  programs 
to  invoke  the  linker  by  typing  LINK  on  the  command  line  (/SE:256  is  not  needed  for 
single-module  programs)  and  respond  to  the  four  prompts  which  correspond  directly 
to  the  four  links  of  the  link  file:  object  file  name,  executable  file  name,  map  file 
name,  and  libraries  required  (AGGREG  uses  CLIPPER.LIB  and  EXTEND.LIB; 
REINDEX  uses  CLIPPER.LIB).  Each  prompt  provides  a  default  choice  in  square 
brackets  ([  ])  which  can  be  accepted  by  just  pressing  the  [•* — Enter]  key. 
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